home *** CD-ROM | disk | FTP | other *** search
/ Network CD 1 / Network CD.iso / compression / muchmore_doc < prev    next >
Text File  |  1993-12-23  |  21KB  |  577 lines
  1.  
  2.                         M u c h M o r e   V 3.7
  3.                      ============================
  4.  
  5.  
  6.                       © 1992 by Fridtjof Siebert
  7.                              Nobileweg 67
  8.                           D-70439 Stuttgart
  9.                                Germany
  10.  
  11.                    EMail: fridi@amokst.adsp.sub.org
  12.  
  13.  
  14.                    Enhancements since Version 3.2 by
  15.  
  16.  
  17.                           Christian Stiens
  18.                              Heustiege 2
  19.                         D-59348 Lüdinghausen
  20.                               Germany
  21.  
  22.             EMail: Christian_Stiens@ouzonix.bo.open.de (UUCP)
  23.                           2:243/4802.25 (Fido) 
  24.  
  25.  
  26.  
  27.   What is MuchMore?
  28.  
  29.     MuchMore is  another  program  like  More,  Less  etc.  that prints
  30.     ASCII-Files to the screen.  Unlike these, it opens its  own  screen
  31.     to show  the  text  and  to scroll it softly!  But not only softly,
  32.     MuchMore is also able to scroll very quickly if  you  want  it  to!
  33.     Furthermore,  there are commands to search for strings and to print
  34.     the text.  MuchMore will run on any  Amiga,  whether  it's  a  PAL,
  35.     NTSC, overscan  or  any Amiga in future.  Because MuchMore's screen
  36.     has no border, there are 80 characters displayed per line.
  37.  
  38.     MuchMore can load  texts,  which are  crunched or crypted by XPK or
  39.     powerpacker,  if  you  have  installed  the XPK  (and  powerpacker)
  40.     libraries.
  41.  
  42.     MuchMore can be made resident with the Resident command of AmigaDOS.
  43.  
  44.  
  45.   Why MuchMore instead of MORE, BLITZ or LESS?
  46.  
  47.     MuchMore  is much shorter than  LESS. BLITZ or other  programs that
  48.     scroll quickly or softly usually use 2 Colors and don't support any
  49.     special fontstyles.  MuchMore instead has four Colors and  displays
  50.     bold,  italic,  underlined  and  inverse  text.  Unlike many  other
  51.     programs, MuchMore may use any non-proportional Font to display the
  52.     text.
  53.  
  54.     MuchMore is  ideal  to  display  long  texts.    The text is loaded
  55.     simultaneously while it  is   displayed.   That  is,  while  you're
  56.     reading  the first page, the rest of the text is loaded into memory
  57.     and you're able to move  through  the  text  quickly  then  without
  58.     re-loading it.
  59.  
  60.  
  61.   How to start MuchMore:
  62.  
  63.     CLI:
  64.  
  65.       Kickstart 1.3:
  66.  
  67.       MuchMore [-a#|-b#|-c#{,#}|-e#|-f<font>/#|-i<editor>|-o|-p#|
  68.                -s|-t#|<file>]
  69.  
  70.       Kickstart 2.04 or higher:
  71.  
  72.       Template:
  73.       B=PLANES/N/K,C=PALETTE/K,D=DISPMODEREQ/S,E=EDITOR/K,F=FONT/K,
  74.       O=OLDSTYLE/S,P=TOOLPRI/N/K,S=SCROLLRASTER/S,T=TABWIDTH/N/K,
  75.       X=EXTRASPACE/N/K,FILE
  76.  
  77.       'FILE' is the  name of  the  ASCII-Text  that is to be displayed.
  78.       If there  are any spaces in  the filename, it must be enclosed by
  79.       quotes. "MuchMore ?" displays  the usage.  If MuchMore is started
  80.       without an  argument it will ask for  the  filename  using a file
  81.       requester.
  82.  
  83.       With option 'T=TABWIDTH' you can set the tabulator width (default
  84.       is 8).
  85.  
  86.       With  option 'C=PALETTE'  you can  set the  colors for MuchMore's
  87.       screen. Example: -cAAA,000,f00,0f0
  88.  
  89.       If you set D=DISPMODEREQ, then a requester appears, with that you
  90.       can choose the  display mode  for  the  screen.  If you  click on
  91.       'Save'  then the  setting is  saved to  'ENV:muchmore.prefs'  and
  92.       'ENVARC:muchmore.prefs'.
  93.  
  94.       The  option  'X=EXTRASPACE' tells  MuchMore to put the specified
  95.       number of pixels between the lines.
  96.  
  97.       You  may select a font by providing the option 'F=FONT'. To force
  98.       MuchMore  to  use   Topaz 11,  type 'MuchMore F=topaz/11'.  Only
  99.       fixed width fonts are allowed.
  100.  
  101.       Option 'E=EDITOR' tells MuchMore  which editor to use if the user
  102.       hits Alt-Shift-E. Default is 'C:ED'. If there is no %s then %s is
  103.       appended. The %s is replaced with the file name.
  104.  
  105.       The  option 'B=PLANES' determines  the  number of  Bitplanes  for
  106.       MuchMore's screen. The maximum is two planes.
  107.  
  108.       IF you set option 'O=OLDSTYLE',  then pageup/down is with a soft-
  109.       scroll, like in older versions of MuchMore.
  110.  
  111.       If you set 'S=SCROLLRASTER' then MuchMore scrolls not with
  112.       RasInfo.dyOffset but with ScrollRaster. This is for not dragable
  113.       Screens like the 2024 monitor mode.
  114.  
  115.       You can specify MuchMore's task priority with option 'P=TOOLPRI'.
  116.  
  117.       MuchMore's  Tooltypes  are   evaluated  now  also  on  CLI-Start
  118.       (KS 2.04). If MuchMore is resident then the icon is searched
  119.       in C:
  120.  
  121.     Workbench:
  122.  
  123.       Just click the text to be printed with your mouse and then shift-
  124.       doubleclick MuchMore.
  125.  
  126.       Texts with  MuchMore as  their  default-tool (e.g.  ":c/MuchMore"
  127.       when MuchMore has been copied to the disk's :c/ directory) can be
  128.       displayed easily by doubleclicking them.
  129.  
  130.       MuchMore supports the following Tooltypes:
  131.  
  132.          PALETTE=#{,#}          corresponding to CLI Option C
  133.          EXTRASPACE=#           corresponding to CLI Option X
  134.          FONT=name/size         corresponding to CLI Option F
  135.          EDITOR=name            corresponding to CLI Option E
  136.          OLDSTYLE=TRUE|FALSE    corresponding to CLI Option O
  137.          PLANES=#               corresponding to CLI Option B
  138.          SCROLLMODE=#           corresponding to CLI Option S
  139.          TABWIDTH=#             corresponding to CLI Option T
  140.          TOOLPRI=#              corresponding to CLI Option P
  141.  
  142.       The tooltypes of the text have priority over MuchMore's tooltypes.
  143.  
  144.     If the text is crypted then you have to enter the password in the
  145.     stringgadget which appears before the text is loaded.
  146.  
  147.  
  148.   MuchMore's commands:
  149.  
  150.     The commands are activated by pressing the corresponging keys:
  151.  
  152.       Space or left mousebutton:
  153.  
  154.                  Stops  or  restarts  scrolling.   While  scrolling  is
  155.                  stopped  the  filelength,  linenumber  and the current
  156.                  percentage of the text are displayed in the bottommost
  157.                  line.
  158.  
  159.                  Pressing space at the end of the texts quits MuchMore.
  160.  
  161.       BackSpace or right mousebutton:
  162.  
  163.                  Stops or restarts  backwards  scrolling. Works similar
  164.                  to the Space-Key.
  165.  
  166.       Up/Down or 2/8 of the numeric keypad:
  167.  
  168.                  Scrolls one line up or down.
  169.  
  170.                  If you  press these  keys together  with the shift-key
  171.                  you can start and stop fast scrolling.
  172.  
  173.                  Control  plus these  keys  increased  scroll speed 2-3
  174.                  times.
  175.  
  176.                  Alternate plus these keys scroll one page up or down.
  177.  
  178.       PgUp / PgDn (numeric keypad):
  179.  
  180.                  Scroll up or down one page.
  181.  
  182.       T (top) or Home:
  183.  
  184.                  Moves to top of text.
  185.  
  186.       B (bottom) or End:
  187.  
  188.                  Moves to bottom of text.
  189.  
  190.       F (find):
  191.  
  192.                  Waits for a string to be entered and searches for this
  193.                  string   starting   at   the  topmost  line  currently
  194.                  displayed on  the  screen.   If you  press <shift>-<f>
  195.                  then the search is  case-sensitive.  If you press  key
  196.                  'f' without shift then the  search will be case-insen-
  197.                  sitive.  If the string is found,  the line  containing
  198.                  the string will be  displayed  and  the  found  string
  199.                  will be highlighted. Else the screen will flash.
  200.  
  201.       N (next):
  202.  
  203.                  Searches for the next  occurance of the string entered
  204.                  with `F'. See above.
  205.  
  206.       P (previous):
  207.  
  208.                  Searches  for  the  previous  occurence  of the string
  209.                  entered with `F'. It  starts  with  the  topmost  line
  210.                  that's currently displayed and searches backwards.  If
  211.                  the  search  is  succesful,  the  line  containing the
  212.                  string will be displayed like it is by the  F-Command.
  213.                  Else a beep will be displayed.
  214.  
  215.       Shift + Fn:
  216.  
  217.                  Shift plus one of F1 to F10  sets a text marker at the
  218.                  current position.
  219.  
  220.       Fn:
  221.  
  222.                  Jumps to the text marker #n that's been set with Shift
  223.                  plus Fn.  If text marker #n isn't set yet,  it will be
  224.                  set to the current position,  as it would have been if
  225.                  you had pressed shift plus Fn.
  226.  
  227.       G (goto):
  228.  
  229.                  Opens a Window  with an integer-gadget.  You can enter
  230.                  the number of the line that is to be displayed.
  231.  
  232.       Shift + Alt + E (edit):
  233.  
  234.                  Calls an text editor by executing "C:ED %s" with  %s
  235.                  replaced by  the actual  file name.  If the text was
  236.                  crunched then  the  decrunched text in "T:"  will be
  237.                  editied.
  238.  
  239.       Shift + Alt + O (printout):
  240.  
  241.                  Prints the  text.    This  is  done with "TYPE text TO
  242.                  PRT:".  So  it  works  with  any  printer   when   the
  243.                  preferences are  set correctly.  The commands TYPE and
  244.                  RUN must occur in the current C: directory.  You don't
  245.                  have to wait while printing.  You can continue reading
  246.                  the text with MuchMore. I hope that it  is  impossible
  247.                  to  press shift+alt+o accidentally, so you won't print
  248.                  a 100k text when you in fact don't  need  a  printout.
  249.                  The printing cannot be interrupted, but you can switch
  250.                  off  your  printer  and  wait  for the printertrouble-
  251.                  requester :-).
  252.  
  253.       W (write):
  254.  
  255.                  Writes the  text that's marked between the textmarkers
  256.                  that have been set with F1 and F2 to a file or to PRT:
  257.                  when  you  accept the  default filename.  The text  is
  258.                  saved starting at  the topmost line of the page marked
  259.                  with  F1 until  the bottommost line of  F2's page.  To
  260.                  print  the  current   page  you  just  press  Shift+F1,
  261.                  Shift+F2, w and RETURN.
  262.  
  263.       C (copy):
  264.  
  265.                  Copies the text that's marked  between the textmarkers
  266.                  that have  been set with  F1 and F2  to the clipboard.
  267.                  This  command  requires the  iffparse.library of Work-
  268.                  bench 2.04+.
  269.  
  270.       L (load):
  271.  
  272.                  Opens the filerequester and loads a new text.
  273.  
  274.       HELP or H:
  275.  
  276.                  Shows all  MuchMore-Commands.  This way  everybody who
  277.                  doesn't have this documentation file should be able to
  278.                  use  MuchMore.  After  pressing  any  key  the text is
  279.                  displayed again.
  280.  
  281.       ESC, Q, X or 5 of the numeric keypad:
  282.  
  283.                  Quit MuchMore. To avoid leaving the program by mistake
  284.                  the keys Q, X and NK5 first show the info  line before
  285.                  quitting.
  286.  
  287.  
  288.   The Files in this package:
  289.  
  290.     MuchMore       The executable
  291.     MuchMore.doc   This textfile
  292.     MuchMore.dok   German documentation
  293.  
  294.     src (dir)      This directory contains the source:
  295.  
  296.       MuchMore.mod      The OBERON Source
  297.  
  298.  
  299.   Disclaimer:
  300.  
  301.     The use of this program is on your own risk. There  is no liability
  302.     or responsibility for any damage caused by the program.
  303.  
  304.  
  305.   Copyright:
  306.  
  307.     MuchMore is free to be spread on public-domain and shareware disks,
  308.     as long as they  are sold for a reasonable charge.  It may be used
  309.     there to display readme- and  documentation-files.  My name has to
  310.     be left in the program (HELP).
  311.  
  312.     Although MuchMore is not Shareware, donations are welcome.
  313.  
  314.     It's not allowed to use this in a commercial way without my written
  315.     permission.  This permission is  also  necessary  if  you  want  to
  316.     publish  MuchMore as a  part of a  commercial product or use this
  317.     program commercially in any other way.
  318.  
  319.     If you change anything in my source you're allowed to put your name
  320.     in the program's head (:History.), but leave my name in!  If you've
  321.     made  any  enhancements,  please  send them to me (else there'll be
  322.     thousands of different versions).
  323.  
  324.  
  325.   Compiling:
  326.  
  327.     MuchMore was  written  in Oberon-2 using the Amiga Oberon Compiler
  328.     V3.01.  You  can  find a  demo version  of the  Compiler  on  Fish
  329.     Disk #880.
  330.  
  331.  
  332.   Revisions:
  333.  
  334.    v1.0:
  335.  
  336.       - this version was terribly slow and therefore not published!
  337.  
  338.    v1.1:
  339.  
  340.       - first published version.
  341.  
  342.    v1.2:
  343.  
  344.       - now  the  file's  name,  its  length  etc. are  displayed  when
  345.         scrolling is stopped with <Space>.
  346.       - now left and right mousebutton can be used instead of space and
  347.         backspace.
  348.       - controlcodes aren't displayed anymore.
  349.  
  350.    v1.3:
  351.  
  352.       - Strong  increase in  speed while  scrolling. WarpText  has been
  353.         replaced by  QText (Sorry, Bill).  MuchMore  is  now as fast as
  354.         Blitz (with Video Sync) although it uses a bigger screen.
  355.       - Now supports numeric keypad (home, end, PgUp etc.)
  356.       - Now the screen  gets it's  size from gfxbase^.normalDisplayXXX.
  357.         This way  MuchMore  can  be run  on PAL,  NTSC, Amigas  with an
  358.         Overscan- Workbench (like mine),  and on resolutions that'll be
  359.         used  in  future.  It always  opens  its screen  as big  as the
  360.         current Workbenchscreen.
  361.  
  362.    v1.4:
  363.  
  364.       - Displaying  and  loading  of  the  text  are  now  done  by two
  365.         asynchroneous tasks.  Scrolling is  more  homogeneous  now  and
  366.         there are no more stops to load further text.
  367.       - The feature to display several texts has been removed.
  368.       - Bugs in filelength and end-function removed
  369.       - New commands: find, next, previous to search for strings
  370.       - Scrolling stops when MuchMore's window becomes inactive.
  371.  
  372.    v1.5:
  373.  
  374.       - New command: print text (shift+alt+o)
  375.       - removed all imports to make MuchMore shorter
  376.       - added numeric key 5 to quit
  377.  
  378.    v1.6:
  379.  
  380.       - From this  version on  texts with  different fontstyles  (bold,
  381.         italics, inverse) and different colors can be displayed!
  382.  
  383.    v1.7:
  384.  
  385.       - Now MuchMore is again as fast as MuchMore v1.5 was, although it
  386.         uses 2 bitplanes and uses several fontstyles.
  387.       - Print  (shift+alt+o)  doesn't  crash   anymore  when  you  quit
  388.         MuchMore before printing is complete.
  389.  
  390.    v1.8:
  391.  
  392.       - Bug which occured  when searching for  a string having searched
  393.         for a longer string, removed.
  394.       - Strings found while execution of F, N or P are highlighted now.
  395.       - Added NK0 to display filelength etc.
  396.  
  397.    v2.0:
  398.  
  399.       - Ported MuchMore to OBERON
  400.       - Removed bug that caused RMB not  to work on some amigas (it did
  401.         work on my computer)
  402.       - now uses the arp-filerequester
  403.       - new command: L = load new text
  404.  
  405.    v2.1:
  406.  
  407.       - Read-/write-errors used to create some very interesting crashes
  408.         with colorful graphics  and stereo sound.  I'm sorry, but I had
  409.         to remove this.
  410.       - CSI-Codes  have been executed BACKWARDs.  This caused  problems
  411.         with sequences like <CSI>0;4m. Fixed now.
  412.       - New Commands: Ping & Pong, Goto
  413.       - First  page  is  displayed  immediately  now  when  MuchMore is
  414.         started.
  415.  
  416.    v2.2:
  417.  
  418.       - Now MuchMore uses console's keymapping instead of the hardcoded
  419.         one it  used  before.  So  there  won't  be  problems with  any
  420.         japanese keymaps.
  421.  
  422.    v2.3:
  423.  
  424.       - New   command: 's'  (sleep)   and  pop  up  function  lAlt+ESC.
  425.         'MuchMore -s' sleeps immediately.
  426.       - Bug in interpretation of <CSI>[m fixed.  <CSI>[m is now treated
  427.         as <CSI>[m.
  428.  
  429.    v2.4:
  430.  
  431.       - New Command: 'w' to write block to file or priner
  432.       - Argumentparser rewritten. Now supports quotes.
  433.  
  434.    v2.5:
  435.  
  436.       - Uses 8x8 Font set with SetFont instead of topaz 8.
  437.       - Allocates 4K Memory chunks instead  of one memorychunk for each
  438.         line.  So MuchMore  won't scatter  the Memory anymore.  Another
  439.         positive effect  is that MuchMore  needs less nemory now (about
  440.         14 Bytes per line).
  441.  
  442.    v2.6:
  443.  
  444.       - asynchronous fast scrolling with the ctrl-key.
  445.       - MuchMore is reentrant (pure)
  446.       - MuchMore uses  an interlace screen when  the preferences  are  set
  447.         accordingly.
  448.       - On low chip-memory, MuchMore uses a 1-plane screen.
  449.  
  450.    v2.7:
  451.  
  452.       - '-l' to toggle interlaced mode
  453.       - uses ASL's FileRequester
  454.       - no more calls RethinkDisplay() 50 (or even 60) times a second
  455.  
  456.    v2.8:
  457.  
  458.       - leaves some spaces between the lines on interlace screens to make
  459.         the text more readable.
  460.  
  461.    v3.0:
  462.  
  463.       - sleep ('-s') is no more supported (was rarely used).
  464.       - now MuchMore uses any non-proportional font.
  465.       - new options to select a font: '-f<font>' and '-s<size>'.
  466.  
  467.    v3.1:
  468.  
  469.       - Uses Screenmode of Workbench Screen
  470.  
  471.    v3.2:
  472.  
  473.       - Support for not srollable Screens
  474.       - No more Scrolling if complete display rebuilding
  475.  
  476. --- Fridtjof.
  477.  
  478.    v3.2.1:
  479.  
  480.       - XPK Support
  481.       - New Syntax for option -f. Example: -ftopaz/11
  482.       - New option -p for Password
  483.       - New option -e for Extra Spacing
  484.       - New option -c for Screen Colors. Example: -c0,abc,f00
  485.       - Tool-Types
  486.  
  487.    v3.2.2:
  488.  
  489.       - The last version displayed the first two chars of each line
  490.         at the end of the line on some overscan dimensions.
  491.  
  492.    v3.2.3:
  493.  
  494.       - The non-scroll mode now works under KS2.04 when using a 8x8 font
  495.       - The Console-Device wasn't closed
  496.       - Display Mode Requester
  497.       - New option -s for Scrollmode
  498.       - Busypointer
  499.       - ToolType evaluation if CLI started (AmigaOS 2.04)
  500.       - Finds MuchMore's Tooltypes now also, if MM as default tool of the
  501.         Text wasn't found directly but over the Dos search path.
  502.  
  503.    v3.2.4:
  504.  
  505.       - Some bugs in GetString() removed
  506.       - MM now ignores key/mouse strikes while it is busy
  507.  
  508.    v3.2.5:
  509.  
  510.       - Asynchronous scrolling changed.
  511.       - Dos.ReadArgs
  512.       - New Option -t / "T=TOOLPRI" for task priority
  513.  
  514.    v3.2.6:
  515.  
  516.       - Scrollmode 3 scrolls soft
  517.       - Scrollmode 1 is default under KS2.04 and higher
  518.       - New option -a or "A=TABWIDTH" for tabulator width
  519.       - New option -o or "O=ONEPLANE"
  520.       - New option "N=NOOSCAN"
  521.       - Opens screen with full overscan width
  522.       - Uses QText no more
  523.  
  524.    v3.2.7:
  525.  
  526.       - MM doesn't poke to his bitplanes no more, but uses the
  527.         funcs of graphics.library for this purpose
  528.  
  529.    v3.2.8:
  530.  
  531.       - Option "O=ONEPLANE" removed
  532.       - new Option "B=PLANES" instead
  533.  
  534.    v3.2.9:
  535.  
  536.       - implemented V36 ANSI Codes (<CSI>22-28m)
  537.  
  538.    v3.2.10:
  539.  
  540.       - Locale Support
  541.       - Made Display Mode Requester font-sensitive
  542.  
  543.    v3.3:
  544.  
  545.       - Keys Q, X and NK5 quit after first showing the info line
  546.         to avoid unintended quitting
  547.  
  548.    v3.4:
  549.  
  550.       - Key 'c' copies the text between markers #1 and #2 to the
  551.         clipboard
  552.  
  553.    v3.5:
  554.  
  555.       - Search can be case-sensitiv or case-insensitiv
  556.       - Searching now with Boyer-Moore Algorithm
  557.  
  558.    v3.6:
  559.  
  560.       - New Option O=OLDSTYLE for page up/down w/ softscroll
  561.       - Screen flashes when pressing Up (Down) at BOF (EOF)
  562.  
  563.    v3.7:
  564.  
  565.       - New Option E=EDITOR
  566.       - MM was not 100% pure because the BusyPointer image was
  567.         not copied -> Probs with WShell
  568.       - Option PASSWORD removed. Password must be entered in a
  569.         string gadget
  570.       - Options NOOSCAN and SCROLLRASTER removed
  571.       - Text was not printed if filename contained spaces
  572.       - MuchMore crashed under Kick 1.3 when displaying italic
  573.         text due to a bug in Kickstart 1.3.
  574.  
  575. --- Christian.
  576.  
  577.